home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 4 / ETO Development Tools 4.iso / Tools - Objects / MacsBug / MacsBug 6.1 / Read Me First < prev   
Text File  |  1989-04-21  |  3KB  |  64 lines
  1. Installing MacsBug:
  2.  
  3. Copy the files MacsBug and "Debugger Prefs" to the System folder on your
  4. boot disk and reboot.  The MacsBug file is required.  The "Debugger Prefs"
  5. file is optional.  It contains macros, templates and other MacsBug resources
  6. that are loaded if present.
  7.  
  8.  
  9.  
  10. Installing MacsBug to minimize RAM usage:
  11.  
  12. Copy the file MacsBug to the System folder on your boot disk.  Use ResEdit
  13. to remove the 'mxbh' resource (help text) from the MacsBug file that you just
  14. copied.  Make sure there is not a debugger prefs file in your System folder.
  15. Reboot.
  16.  
  17.  
  18.  
  19. What the Resources folder contains:
  20.  
  21. This folder contains the following resources that can be pasted into the
  22. Debugger Prefs file to increase MacsBug functionality.
  23.  
  24.     Floating Point        Macros to support A-Trap breaks at FP68K calls
  25.     HFS Calls            Macros to support A-Trap breaks at HFSDispatch calls
  26.     List Manager        Macros to support A-Trap breaks at Pack0 calls
  27.     C++                    Code to unmangle C++ names
  28.     KCHR                The key map to use for the MacsBug keyboard.
  29.                           This is used to debug international software.
  30.  
  31. The folder "MPW .r files" contains the text that was used to create the
  32. MacsBug resources.  Macros.r, Templates.r, Init.r and Color.r are shipped
  33. as resources in the Debugger Prefs file since they are commonly used.
  34. FloatingPoint.r, HFSCalls.r and ListManager.r are shipped as separate
  35. resources since they are not as widely used.
  36.  
  37. The Debugger Prefs file also contains TMPL resources used by ResEdit to edit
  38. MacsBug resources.  Earlier versions of ResEdit may require you to paste
  39. them into ResEdit to use them.
  40.  
  41.  
  42.  
  43. What the dcmds folder contains:
  44.  
  45. This folder contains tools used to build and test dcmds,  sample dcmds in both
  46. C and Pascal and contributed dcmds.
  47.  
  48. The MPW tool BuildDcmd is used to convert a linked application into a dcmd and
  49. installs it into the Debugger Prefs file. 
  50.  
  51. The application TestDcmd simulates the environment in which a dcmd executes.
  52. This allows you to use MacsBug while debugging a dcmd.
  53.  
  54. The Samples folders contain the source of dcmds written specifically to
  55. demonstrate the various call back routines used by dcmds.  The source is
  56. provided in both C and Pascal.  This folder also contains the dcmd interface
  57. files (.h and .p respectively) and the glue file to be linked with your dcmd.
  58.  
  59. The Contributed dcmds folder contains dcmds that we find useful at Apple.
  60. Information about each one is available in MacsBug by typing "HELP name".  The
  61. source for these commands is included.  If you write an interesting dcmd and
  62. would like to have it considered for future versions of MacsBug then contact
  63. Michael Tibbott (AppleLink = TIBBOTT) or Tom Chavez (AppleLink = TOM.CHAVEZ).
  64.